home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 647 / buttonsd / shell.doc < prev    next >
Encoding:
Text File  |  1992-10-13  |  10.3 KB  |  314 lines
  1.  
  2.                                 Legal STuff
  3.  
  4. This is the demonstration version of ButtonzBasic™.  It may be copied
  5. and passed around to your friends, so long as all of these files remain
  6. intact and unchanged.  ButtonzBasic™ is the property of MajicSoft and
  7. we retain all rights to this software.  The live version is copyrighted
  8. so please don't pass it around.  If your friends want a copy, tell them
  9. where you got it, so they may order a copy for themselves.  Piracy hurts
  10. everyone, so please don't do it!  Thank you.
  11.  
  12.  
  13.                                 INTRODUCTION
  14.  
  15. ButtonzBasic™  was created to make programming in GFA Basic™
  16. easier, not a tutor program but a utility in which all of the standard
  17. chores of programming and compiling, moving around files, setting compiler
  18. options, etc...are done with ease.  The Menu program that came with
  19. GFA Basic© was not really meant to be a fully functional work area, but
  20. a tool to get you started.  ButtonzBasic™ IS intended to be a fully
  21. functional work area.  The things which make ButtonzBasic™ more useful
  22. are the configuration options that can be saved for future sessions,
  23. a simple click of a button to get you going from editing to compiling and
  24. linking with as many objects as you desire.  Not only this but disk
  25. commands if you are not using other accessories which have disk commands
  26. available.  Also ButtonzBasic™ supports all ST resolutions in the same
  27. program.
  28.  
  29.  
  30.                                SPECIAL NOTICE
  31.  
  32. Before we start with the program, I want to take just a moment of your
  33. time to thank all of our BETA testers for their time and effort.  Many of
  34. the features of this program were brought about by the suggestions of
  35. of the BETA testers.  Also, many bugs were stamped out by the devotion
  36. and their attention to minute detail.  The BETA testers (in no special
  37. order) are Wayne Watson, Dave Hubbell, Russell Rhoades, Larry Scholz and
  38. Burt Lee.  A big thank you goes out to these special guys!
  39.  
  40.  
  41.                                MAIN SCREEN 
  42.  
  43.  
  44. ACCESS ACCESSORIES:
  45.  
  46.         The access accessories button lets you get to your accessories.
  47. To exit from your accessories, just select the GOTO ButtonzBasic™ item
  48. and you are back at the main screen.
  49.  
  50.  
  51. SELECT:
  52.  
  53.         The select button lets you select the GFA Basic© file that you
  54. wish work on.  This is the file name that the EDIT button uses also. 
  55. The default source directory initially comes.  You may change the default
  56. source directory from here.
  57.  
  58.  
  59. COMPILE:
  60.  
  61.         The Compile button lets you compile the GFA Basic© file that was
  62. selected using the SELECT button. ( This lets you compile different
  63. modules separately. and later link them all together.)
  64.  
  65.  
  66. LINK:
  67.  
  68.         This button links all objects in the object list to make an
  69. executable program.
  70.  
  71.  
  72. COMPILE & LINK:
  73.  
  74.         The compile and link button does exactly that, it combines
  75. the compile and link buttons into one.  By selecting this button, you
  76. may create an executable program in one easy step.
  77.  
  78.  
  79. EDIT:
  80.  
  81.         The Edit button takes the file name you selected with SELECT
  82. and passes this file name to the GFA Basic© Editor that you selected from
  83. the OPTIONS screen.  Also, the Edit button changes the current default
  84. directory to the Source directory, which you selected in the OPTIONS
  85. screen.  If you make a file selection, your Source directory will
  86. now be the current file directory.
  87.  
  88.  
  89. COMPILE STATUS:
  90.  
  91.         Compile status is a history of the most recent Compile, Link
  92. or Compile & Link operation.  This lets you know what happened the last
  93. time you did one of these operations.
  94.  
  95.  
  96. SAVE CONFIGURATION:
  97.  
  98.         This is the button that lets you save this current screen
  99. selection and the Compile Options.
  100.  
  101.  
  102. EXECUTE PROGRAM:
  103.  
  104.         Well now, any idea what this button might do?  Not to hard is it!
  105. If you have the memory you can execute ANY program you want from here.
  106.  
  107.  
  108. GFA TO:
  109.  
  110.         This button lets you toggle through the available file types
  111. that can be compiled.  Ie... TTP, TOS, PRG, ACC.
  112.  
  113. PRG NAME:
  114.  
  115.         If you wish the LINKed Program to have a different file name
  116. than the source code name, select this BUTTON and enter the custom
  117. name.   (This name is not saved from session to session.)
  118.  
  119.  
  120. COMPILE OPTIONS:
  121.  
  122.         This button brings up a pop-up window that gives you the
  123. available compiler options.  Select by pressing the appropriate toggle
  124. button.  Default options are all in the up right positions.
  125.  
  126.  
  127. SETUP:
  128.  
  129.         This sends you to a new screen and allows you to create a
  130. configuration file.  The selections are for your GFA© library, basic 
  131. editor, compiler, linker, source directory, personal text editor,
  132. resource editor, and the object list.  The objects can be added or
  133. deleted.  GFA©, by default, uses TEST.O.  You can add whatever other
  134. objects you create to be linked into your code. (Warning: you MUST
  135. have at least one object in your list!)  
  136.  
  137.  
  138. TEST:
  139.  
  140.         This is the button that executes your compiled program
  141. as if it was run from the DESKTOP.  If all went well, you will return
  142. back to the MAIN SCREEN after your program terminates.
  143.  
  144.  
  145. DISK:
  146.  
  147.         This button sends you to another screen that lets you do file
  148. operations like free space, copy, move, delete, etc..., there is also
  149. a FORMAT button that lets you custom format floppy disks.
  150.  
  151.  
  152. MEMORY:
  153.  
  154.         The Memory button will display the total memory in your system,
  155. memory used up so far, and the memory available to you at the moment.
  156.  
  157.  
  158. PERSONAL EDITOR:
  159.  
  160.         Programmers all hate to type docs and data files, but at some
  161. point in time we have to do it, right?  So this button is used to get
  162. to your favorite text editor.  The Text Editor you select in the 
  163. SETUP OPTIONS will be used.
  164.  
  165.  
  166. QUIT:
  167.  
  168.         Another toughie?
  169.  
  170.  
  171. ButtonzBasic™:
  172.  
  173.         Well, you know there has to be an "ABOUT BOX", right!  I mean,
  174. you have to know our names so you can buy other products from us,
  175. and know who wrote it and all!.  Also a good place to put the version
  176. ID and Serial Number.
  177.  
  178.  
  179.                                 -> NOTE <-
  180.  
  181.         The compile, link, and compile & link buttons all change
  182. the Compile status window.  The status window only has a one step
  183. history.
  184.  
  185.  
  186.                             SETUP OPTIONS:
  187.  
  188.  
  189. ACCESS accessories:
  190.  
  191.         The access accessories button lets you get to your accessories.
  192. To return to BUTTONZBASIC™, select the GOTO BUTTONZBASIC™ item from the
  193. DESK dropdown menu, and you're back at the SETUP OPTIONS screen.
  194.  
  195.  
  196. ADD OBJECT:
  197.  
  198.         This is one of those handy features of ButtonzBasic™.
  199. You can add object files to the OBJECTS list, and these objects will be
  200. linked together to create your executable program.  If you want the main
  201. source code to be created into a program, you must have a object
  202. called TEST.O in the list or nothing will be created.  The TEST.O is the
  203. name that GFA© Compiler creates to be linked.
  204.  
  205.  
  206. DELETE OBJECT:
  207.  
  208.         To delete an object, first select the object in the LINK listing.
  209. Then click on the DELETE OBJECT button.  This removes the object from the
  210. LINK list, so that it will not be compiled into your program.
  211.  
  212.  
  213. NO/USE 10K KERNAL:
  214.  
  215.         The default setting of this button is "NO 10K KERNAL".  This is
  216. the setting used for machines that have two megabytes of memory or more.
  217. If your machine has less than two megabytes of memory, select the
  218. "USE 10K KERNAL" option, and the shell will only load in one module at
  219. a time.
  220.  
  221.  
  222. SELECT LIBRARY:
  223.  
  224.         This is where you can select which library to use to link
  225. files, in the creation your programs.  Simply press the button and the
  226. file selector will appear.  Find and select your library and click on
  227. OK.  Now ButtonzBasic™ knows where your library is kept. (NOTE: the
  228. standard GFA© library is GFA3BLIB.)
  229.  
  230.  
  231. SELECT EDITOR:
  232.  
  233.         Selecting of the GFA© Editor will let ButtonzBasic™
  234. know where your GFA© Editor is located at. (NOTE: The standard
  235. GFA™ Editor is named GFABASIC.PRG.)
  236.  
  237.  
  238. SELECT COMPILER:
  239.  
  240.         Selecting of the GFA© Compiler will let ButtonzBasic™
  241. know where your GFA© Compiler is located.  This is also a good
  242. way to use different compilers such 3.6, 3.5 or 3.0.
  243.  (NOTE: The standard GFA© Compiler is named GFA_BCOM.PRG.)
  244.  
  245.  
  246. SELECT LINKER:
  247.  
  248.         Much the same as compiler, just select the linker. 
  249.         (NOTE: The standard GFA© Linker is named GL.PRG.)
  250.  
  251.  
  252. RESOURCE EDITOR:
  253.  
  254.         This button executes the resource editor that you selected in
  255. the SETUP screen.
  256.  
  257.  
  258. SOURCE DIRECTORY:
  259.  
  260.         This is where we select the default source directory for
  261. ButtonzBasic™.  This directory will come up when you select the SELECT
  262. button in the main screen.  The source directory becomes the last path
  263. you selected with the SELECT button.  This allows your program to execute
  264. as if it were launched from the DESKTOP.
  265.  
  266.  
  267. SELECT TEXT EDITOR:
  268.  
  269.         The Personal Text Editor button on the MAIN SCREEN calls
  270. the program you've selected here.
  271.  
  272.  
  273. THE LIST BOX:
  274.  
  275.         The LIST BOX can be scrolled one line at a time or a page
  276. at a time.  Use the single arrows to move one line at a time, or
  277. the double arrows to move a page at a time.
  278.  
  279.  
  280.                             -> NOTE <-
  281. Remember to use the SAVE CONFIGURATION button before leaving
  282. this screen or all changes will be lost.
  283.  
  284.  
  285. CONCLUSION:
  286.  
  287.         We at MajicSoft hope you enjoy using ButtonzBasic™.  We also
  288. hope that it speeds your program developement.  We have throughly tested
  289. this program, but as usual, a bug or two may have escaped us.  If you
  290. find a bug or if you have any suggestions for improvement - please write
  291. to us at the following address:
  292.  
  293.                          MajicSoft
  294.                          348 Meredith Square
  295.                          Columbia, SC  29223
  296.  
  297. You may also reach us on our BBS, by calling 803-788-7806.  If you wish
  298. to contact us personally by phone, please call 803-783-7887.
  299.  
  300. Thank you for trying the DEMO version of ButtonzBasic™.  If you wish to
  301. order a live copy, read on.
  302.  
  303.  
  304.                          ORDERING INFORMATION
  305.  
  306. ButtonzBasic™ can be found in many fine Atari retail stores, but if you
  307. are having trouble finding it, you may order it direct from us.
  308.  
  309. To order your live copy of ButtonzBasic™, send a cashiers check or money
  310. order, in the amount of $44.95 plus $3.00 S&H, to the above address.
  311. Please allow four weeks for delivery.  Overseas orders allow six weeks
  312. for delivery.
  313.  
  314.